home *** CD-ROM | disk | FTP | other *** search
/ Amiga News 95 / Amiga News 95.iso / dpat / dpat86 / bm / bordermaker.doc < prev    next >
Text File  |  1994-07-08  |  10KB  |  228 lines
  1.  
  2.  
  3.                                BorderMaker v 1.0r
  4.                                    Manuel de
  5.                                  l'utilisateur
  6.  
  7.  
  8.       Ce manuel décrit la version 1.0r de l'utilitaire BorderMaker.
  9.       BorderMaker est (c)1993-1994 par Michel TOURNAY
  10.       Ce logiciel, écrit en PCQ Pascal,  est  dans  le  domaine  public  donc
  11.    librement distribuable.
  12.       Toute revente est strictement interdite.
  13.       Vous pouvez copier et distribuer ce programme aux conditions suivantes:
  14.  
  15.             - l'ensemble des fichiers doit être fourni;
  16.             - aucun fichier ne doit avoir été modifié;
  17.             - vous ne devez pas demander plus de 40 FF pour cela.
  18.  
  19.       La bibliothèque "reqtools.library" est  (c)1990-1994 par Nico FRANCOIS.
  20.  
  21.       Malgré une utilisation  très fréquente  de cet utilitaire, je  ne  peux
  22.    garantir qu'il ne contient pas d'erreur.  Vous  l'utiliserez  donc  à  vos
  23.    risques et périls. Je ne pourrai en aucun cas  être  tenu  responsable  de
  24.    dommages, directs ou indirects, résultants de l'utilisation de BorderMaker.
  25.  
  26.       !!! ATTENTION !!!
  27.  
  28.       Je signale ici l'existence d'un bug de ce programme. D'après moi ce bug
  29.    ne vient pas de mon programme mais du fichier objet responsable du passage
  30.    des paramètres à la libairie ReqTools. J'appuie cette affirmation  par  le
  31.    fait que la demo en PCQ plante à la fin de son execution.
  32.  
  33.       En quoi consiste ce bug? Ne jouez pas trop avec le requester de fichier!
  34.  
  35.       Je vous conseille de choisir un nom de fichier au début et d'éviter  de
  36.    changer de fichier pour chaque structure.
  37.  
  38.       Sommaire
  39.  
  40.          1. Introduction
  41.          2. Mode d'emploi
  42.             2.1 Démarrage
  43.             2.2 Description des gadgets
  44.             2.3 Raccourci clavier
  45.          3. Le reste
  46.             3.1 Quoi et quand?
  47.             3.2 Contactez moi
  48.             3.3 Historique
  49.  
  50.       1. Introduction
  51.  
  52.          BorderMaker est un programme dedié au programmeurs en PCQ Pascal.
  53.  
  54.          Grâce à lui, vous pourrez facilement créer les bords  de  vos gadget
  55.       dans vos interfaces intuition.
  56.  
  57.          BorderMaker peut écrire 4 types de bords. Ceux cis sont visibles dans
  58.       l'icône de BorderMaker. Leur noms sont :
  59.  
  60.  
  61.                            IN1            OUT1
  62.  
  63.                            IN2            OUT2
  64.  
  65.  
  66.          BorderMaker écrit d'abord  les paires  de points qui sont necessaire
  67.       pour tracer les  droites  qui  forment  les  bords.  BorderMaker  écrit
  68.       ensuite les structures 'Border' qui contiennent le mode,  la couleur et
  69.       la position d'origine du bord.
  70.  
  71.          A NOTER :   BorderMaker crée les bords avec le style WorkBench 2.0 :
  72.                      les couleurs 1  et  2  sont  inversées  par  rapport  au
  73.                      WorkBench 1.3 (et précedent)
  74.  
  75.          BorderMaker est compatible WB 1.2, 1.3, 2.0, 2.04, 3.0. Remerciements
  76.       à Eddy Marynowski pour ses tests sur son 500 WB 1.2, son 600 WB 2.04 et
  77.       son 2000 WB 2.0. Remerciements aussi à Arnaud Leroy pour les tests  sur
  78.       4000.
  79.  
  80.          BorderMaker est un logiciel du domaine  public.  Le  source  en  PCQ
  81.       Pascal est fourni  dans la  distribution.  Que tout programmeur PCQ qui
  82.       lui apporte une amélioration le  fasse  savoir à la communauté Amiga en
  83.       faisant distribuer sa nouvelle version  par le biais du domaine public,
  84.       avec le nouveau source. Toute nouvelle version doit  s'appuyer  sur  le
  85.       dernier source distribué.  Tous les anciens auteurs  doivent être cités
  86.       dans la documentation  et  l'historique doit  être complèté.  Il serait
  87.       bien d'envoyer votre dernière version à tous les anciens auteurs!
  88.  
  89.          La version 1.0r de BorderMaker est différente de la version 1.0  par
  90.       le fait que  cette nouvelle  version utilise  la ReqTools.library  pour
  91.       le choix du fichier et pour confirmer que l'on quitte BorderMaker.
  92.  
  93.       2. Mode d'emploi
  94.  
  95.          2.1 Démarrage
  96.  
  97.             depuis le workbench  :  double-clic sur l'icone... c'est tout!
  98.  
  99.             depuis le cli        :  BorderMaker ne se détache pas du cli.  Si
  100.                                     vous voulez le lancer en arriére plan, il
  101.                                     vous faudra utiliser un  utilitaire  dans
  102.                                     le genre de runback, ou, avec la commande
  103.                                     run de commodore :
  104.                                              run >nil: BorderMaker
  105.                                     BorderMaker ne necessite aucun argument.
  106.  
  107.  
  108.          2.2 Description des gadgets
  109.  
  110.          'Nom du fichier'        :  le nom du fichier à créer.
  111.                                     BorderMaker appelle la requête de fichier
  112.                                     ReqTools pour cela.
  113.                                     Le nom du fichier est indispensable !
  114.                                     Vous pouvez donner au fichier un nom  qui
  115.                                     existe déjà. BorderMaker  vous  demandera
  116.                                     lors de l'écriture s'il  faut  écrire  la
  117.                                     nouvelle structure en bout de fichier  ou
  118.                                     s'il faut écraser l'ancien fichier.  Vous
  119.                                     pourrez aussi arrêter le processus.
  120.  
  121.          'Nom de la structure'   :  Le nom de la structure.
  122.                                     C'est le nom que  l'on retrouvera en tête
  123.                                     de nom des différentes structures créées.
  124.                                     Le  nom  de   la   structure   n'est  pas
  125.                                     indispensable mais fortement conseillé.
  126.  
  127.          'Longueur'              :  Donne  la  longueur  de  la  structure  à
  128.                                     créer. Elle peut varier de 0 à 999.
  129.  
  130.          'Hauteur'               :  Donne la hauteur de la structure à créer.
  131.                                     Elle peut varier de 0 à 999.
  132.  
  133.          'OffsetX|Y'             :  Indique  un  décalage   par  rapport  aux
  134.                                     coordonnées de départ  de  la  structure.
  135.                                     En effet, pour les string gadget, il  est
  136.                                     nécessaire de décaler vers la  droite  et
  137.                                     vers le haut le bord du gadget, sans quoi
  138.                                     le  texte  entré  s'écrit  SUR  le  bord.
  139.                                     Ils peuvent varier de -99 à 999?
  140.  
  141.          'Type de la structure'  :  Le type de la structure.
  142.                                     Ce gadget est un 'Cycle gadget'. Un  clic
  143.                                     dessus fait apparaître un nouveau type de
  144.                                     structure : IN1, IN2, OUT1, OUT2.
  145.  
  146.          'Complement'            :  Active l'écriture des structures  complé-
  147.                                     mentaires pour les structures de type IN1
  148.                                     et OUT1. Le complémentaire du IN1 est  le
  149.                                     OUT1, le complémentaire du  OUT1  est  le
  150.                                     IN1.
  151.  
  152.          'Ecrire'                :  Lance  tout  simplement   l'écriture  des
  153.                                     structures dans le fichier choisi !
  154.                                     Si aucun  nom  n'est défini,  BorderMaker
  155.                                     appelle la requête de fichier ReqTools.
  156.  
  157.  
  158.          2.3 Raccourci clavier
  159.  
  160.              +--------+-------------------------------------------+
  161.              | Touche | Fonction                                  |
  162.              +--------+-------------------------------------------+
  163.              |  'F'   | pour entrer le nom du fichier             |
  164.              |  'S'   | pour entrer le nom des structures         |
  165.              |  'T'   | pour changer le type de structure         |
  166.              |  'L'   | pour modifier la longueur du bord à créer |
  167.              |  'X'   | pour modifier l'offset en X               |
  168.              |  'H'   | pour modifier la hauteur du bord à créer  |
  169.              |  'Y'   | pour modifierl'offset en Y                |
  170.              |  'E'   | pour écrire le fichier                    |
  171.              |  'Esc' | pour quitter le programme                 |
  172.              +--------+-------------------------------------------+
  173.  
  174.  
  175.       3. Le reste
  176.  
  177.          3.1 Quoi et quand
  178.  
  179.             Ici sont regroupées toutes les idées de  modification  et  d'amé-
  180.          lioration que l'on peut (pourrai) appliquer à BorderMaker :
  181.  
  182.                      -  La possibilité  de voir le  bord  à  créer  avant  de
  183.                         l'écrire;
  184.                      -  La possibilité  d'écrire  des structures Intuitext et
  185.                         des structures Gadgets;
  186.  
  187.  
  188.          3.2 Contactez moi
  189.  
  190.              Vous qui utilisez Bordermaker, toutes  propositions  d'améliora-
  191.          tions à faire sont les bienvenues, ainsi que d'options à ajouter.
  192.  
  193.              Les bugs que vous pourriez rencontrer,  faites m'en part et vous
  194.          aurez droit à une version debuggée.
  195.  
  196.                         Contactez moi à cette adresse :
  197.  
  198.                                Michel    TOURNAY
  199.                                27 rue Felix Pres
  200.                                08600 FROMELENNES
  201.                                (     FRANCE    )
  202.  
  203.                  Ou, pour les utilisateurs résidant en FRANCE :
  204.                                    3615 RTEL
  205.                                   bal michelt
  206.  
  207.          3.3 Historique
  208.  
  209. -------------------------------------------------------------------------------
  210.  
  211. v1.0                            14128 octets                           26/12/93
  212.  
  213.                   Premiére version distribuée. Pas de bug connu.
  214.                   Auteur : Michel TOURNAY
  215.  
  216. -------------------------------------------------------------------------------
  217.  
  218. v1.0r                           19876 octets                           15/05/94
  219.  
  220.                   On ne peut  plus  écraser  accidentellement  un
  221.                   fichier!
  222.                   Un bug connu : le systême plante si BorderMaker
  223.                   n'arrive pas à écrire le fichier demandé.  Voir
  224.                   recommandation ci-dessus.
  225.                   Auteur : Michel TOURNAY
  226.  
  227. -------------------------------------------------------------------------------
  228.